home *** CD-ROM | disk | FTP | other *** search
/ The Pier Shareware 3 / The Pier Shareware Number 3 (The Pier Exchange) (1993).iso / gap / gapmerge.doc < prev    next >
Text File  |  1993-09-19  |  13KB  |  331 lines
  1.  
  2.  
  3.       GAP_Merge v1.0                                               9/19/93
  4.  
  5.  
  6.                
  7.                
  8.              GAP_Merge - The Filebase Merger/Re-arranger for GAP
  9.       
  10.           Copyright (c) 1993 RoboSoft Systems. All Rights Reserved.
  11.       
  12.       
  13.       
  14.       GAP_Merge is a GAP filebase maintenance utility that will 
  15.       allow you to merge two GAP filebases together or to re-arrange 
  16.       the ordering of subjects in an existing GAP filebase.  The 
  17.       merge function is great when adding a CD-ROM, such as one of 
  18.       the Pier Exchange CDs, that comes with a GAP filebase.
  19.       
  20.       GAP_Merge will allow you to specify the mapping of subjects 
  21.       from source to destination filebase.  If you want files from 
  22.       Area 0, Subject 5 in the source to end up in Area 2, Subject 3 
  23.       in the destination, GAP_Merge can handle it.  It will also do 
  24.       drive translations so you can map drive E: from the source 
  25.       filebase to drive X: in the destination filebase.
  26.       
  27.       If the destination filebase does not exist, GAP_Merge will 
  28.       create it.  This allows you to use the subject mapping 
  29.       capabilities to move your files around.
  30.       
  31.       GAP_Merge comes in single-node and multi-node versions.  The 
  32.       multi-node version allows you to merge filebases while users 
  33.       are still online.  (This isn't really recommended due to the 
  34.       heavy load the merge places on the system, but you can do it 
  35.       if you have to.)
  36.       
  37.       Disclaimer
  38.       ----------
  39.       
  40.       GAP_Merge is provided AS IS without any warranty, expressed
  41.       or implied, including, but not limited to, fitness for any
  42.       purpose.  Use of GAP_Merge, and the consequences thereof, are
  43.       entirely your risk.  In no event will RoboSoft Systems be
  44.       liable for any damages whatsoever resulting from the use of
  45.       GAP_Merge.
  46.       
  47.       
  48.       Shareware
  49.       ---------
  50.       
  51.       GAP_Merge is a Shareware product.  As such, it is made
  52.       available to the GAP sysop community for evaluation.  Users
  53.       are licensed to operate this program on their computers for
  54.       the purpose of test and evaluation on a trial basis for 30
  55.       days.  If GAP_Merge is used after the first 30 days,
  56.       registration with RoboSoft Systems is required.
  57.       
  58.       The non-registered demonstration version has limitations.
  59.       See "Limitations" at the end of this document for complete
  60.       details.
  61.       
  62.  
  63.  
  64.                                       -1-                                 
  65.  
  66.  
  67.  
  68.  
  69.       GAP_Merge v1.0                                               9/19/93
  70.  
  71.  
  72.       Registration
  73.       ------------
  74.       
  75.       Registered users are those users who elect to pay for
  76.       GAP_Merge and register that payment with RoboSoft Systems. By 
  77.       virtue of registration and payment for the program,
  78.       registered users are granted a license to continue to utilize 
  79.       the program on their personal computer for as long as they 
  80.       choose.  This license authorizes use of the program on any 
  81.       personal computer system the user may own or use so long as 
  82.       the program is operated on only one computer system at a 
  83.       time.  Use on multiple systems simultaneously requires 
  84.       multiple registrations.
  85.       
  86.       The registration fee for GAP_Merge is $15.  Please make
  87.       checks payable to:
  88.       
  89.                             RoboSoft Systems
  90.                              P.O. Box 2221
  91.                             Orange, CA  92669
  92.       
  93.       The payment of this registration fee to RoboSoft Systems
  94.       entitles the user to full use of GAP_Merge for an unlimited
  95.       period of time.  See the file REGISTER.DOC for complete
  96.       registration details.  
  97.       
  98.       
  99.       Updates
  100.       -------
  101.       
  102.       Updates to GAP_Merge will be provided via BBS free of charge
  103.       to registered users.  Updates on diskette are available for a 
  104.       nominal charge to cover materials and handling.
  105.       
  106.       
  107.       Support
  108.       -------
  109.       
  110.       Support for GAP_Merge is available on The Cookie Jar BBS at
  111.       714-997-0350.  Registered users will be granted access to the 
  112.       private node of the BBS and will be given priority in having 
  113.       their questions answered.
  114.       
  115.       Distribution
  116.       ------------
  117.       
  118.       GAP_Merge may be freely distributed on any Bulletin Board
  119.       System (BBS), including commercial systems such as CompuServe 
  120.       (CIS), Genie, and BIX.  GAP_Merge may be distributed by 
  121.       diskette by any organization or disk distributor as long as 
  122.       the fee for this distribution is no greater than $5 and it is 
  123.       made clear to the purchaser that the distribution fee is NOT 
  124.       the same as the registration fee.
  125.       
  126.       Feel free to pass around copies of GAP_Merge, however, please
  127.       distribute all of the original files and do not modify any of 
  128.  
  129.  
  130.                                       -2-                                 
  131.  
  132.  
  133.  
  134.  
  135.       GAP_Merge v1.0                                               9/19/93
  136.  
  137.  
  138.       the files.
  139.       
  140.       
  141.       Enough with the BS, how do I use this thing?
  142.       --------------------------------------------
  143.       
  144.       GAP_Merge requires no command line parameters and may be 
  145.       executed from any directory.  It will interactively prompt for 
  146.       all the information it needs to merge the filebases.  Please 
  147.       note: GAP_Merge does NOT make a backup of the destination 
  148.       filebase.  It is strongly recommended that you make backup 
  149.       copies of FILES.DAT, FILES.IDX, FILEKEY.DAT, and FILEKEY.IDX 
  150.       before running GAP_Merge.
  151.       
  152.       After a couple opening informational screens, GAP_Merge will 
  153.       start asking for information.  It is expected that the source 
  154.       and destination filebases are in separate directories.  
  155.       GAP_Merge prompts for these directories.  If a GAP filebase 
  156.       does not exist in the destination directory, GAP_Merge will 
  157.       ask if you want to create one. 
  158.       
  159.       You must also specify which filebase will take precedence in 
  160.       the case of a collision.  Highlight either Source or 
  161.       Destination and press the Space Bar, or click with your mouse 
  162.       on the desired option.  If you specify Source, the 
  163.       information about all files common to both filebases will be 
  164.       deleted from the destination and the information from the 
  165.       source filebase added to the destination.  If you specify 
  166.       Destination, the source filebase information about common 
  167.       files will be ignored and the information in the destination 
  168.       filebase will remain.  If you're merging a CD-ROM filebase into 
  169.       your existing GAP filebase, you'll probably want to give the 
  170.       CD-ROM filebase precedence.
  171.       
  172.       GAP_Merge can also automatically delete duplicate files from 
  173.       your disk.  This is handy for removing files from your hard 
  174.       drive that are duplicated on a CD-ROM.  Deletions will only 
  175.       occur if the source and destination file are in the same Area 
  176.       (Forum).  The file that's deleted is the one from the filebase 
  177.       that does NOT take precedence.
  178.       
  179.       Next is the Drive Translation screen.  The drive letters in 
  180.       the Source column are changed into the drive letters in the 
  181.       Destination column before the files are added to the 
  182.       destination filebase.  This can be used to map CD-ROM files to 
  183.       their location on your system.  For instance, if the CD-ROM 
  184.       filebase indicates the files are on drive D: but your CD-ROM 
  185.       is drive L:, simply put 'L' in the Destination column opposite 
  186.       the 'D' in the Source column.  To exit this screen press ESC 
  187.       or click on the system box in the upper left corner of the 
  188.       window.
  189.       
  190.       At this point GAP_Merge begins collecting information about 
  191.       the source filebase.  This will probably take a few minutes, 
  192.       but it should not be too bad.  A counter is displayed during 
  193.       this time so you know something is happening.  Once this 
  194.  
  195.  
  196.                                       -3-                                 
  197.  
  198.  
  199.  
  200.  
  201.       GAP_Merge v1.0                                               9/19/93
  202.  
  203.  
  204.       information is collected, GAP_Merge will display a list of 
  205.       the Area/Subject combinations found in the source filebase.
  206.       
  207.       You can now specify where in the destination filebase the 
  208.       source files should be placed.  If there is an Area/Subject in 
  209.       the source that you don't want merged into the destination, 
  210.       you can specify a Subject of zero as the destination Subject 
  211.       number and that Subject will not be merged.
  212.       
  213.       You can also indicate default values for Security Level, 
  214.       Password, Free File indicator, and Normal Log indicator.  If 
  215.       Security Level is -1, the value from the source filebase will 
  216.       be copied to the destination.  If it's any other value, that 
  217.       value will be used as the Security Level for all files from 
  218.       that Area/Subject in the source filebase.  
  219.       
  220.       If Password, Free File, and/or Normal Log is blank, the value 
  221.       from the source filebase will be copied to the destination 
  222.       filebase.  Any other value will be used as the value for that 
  223.       field for all files from that Area/Subject in the source 
  224.       filebase.
  225.       
  226.       When all the Area/Subject mappings have been specified, press 
  227.       ESC or click on the system box in the upper left corner of the 
  228.       window.  You'll then be asked if you wish to proceed or cancel 
  229.       the merge.
  230.       
  231.       From here on, the merge process will proceed without further 
  232.       input.  A status screen will be displayed showing the current 
  233.       file and an indication of the approximate percent completion 
  234.       of the merge.  You may press the ESC key at any time to 
  235.       interrupt the merge process.
  236.       
  237.       GAP_Merge maintains a log (GAPMERGE.LOG) of collisions and 
  238.       file deletions, if any.  If you don't have GAP_Merge delete 
  239.       duplicate files from your hard drive, you can use the log file 
  240.       to identify duplicates and delete them manually after 
  241.       GAP_Merge finishes.  
  242.       
  243.       For complete, step-by-step instructions on how to use GAP_Merge,
  244.       see QUICK.DOC.
  245.       
  246.       Limitations
  247.       -----------
  248.       
  249.       GAP_Merge does NOT physically move any of the files in your 
  250.       filebase.  If you have your files in directories that are 
  251.       named according to the directory number (e.g. DIR001), you 
  252.       could end up with a real mess if you use GAP_Merge to 
  253.       reorganize an existing filebase.  Be sure to write down all 
  254.       the "before" and "after" subject numbers so you'll know how  
  255.       to change the directory names after the reorganization.  It 
  256.       is strongly recommended that you name your directories 
  257.       according to the topic, not according to the subject number.  
  258.       (e.g.  COMM instead of DIR001)  This should make it 
  259.       unnecessary to change the directory names again should you 
  260.  
  261.  
  262.                                       -4-                                 
  263.  
  264.  
  265.  
  266.  
  267.       GAP_Merge v1.0                                               9/19/93
  268.  
  269.  
  270.       decide to move your files around in the future.  
  271.       
  272.       If you've used the numerical directory labelling scheme, 
  273.       please note that it's NOT necessary to physically move the 
  274.       files.  You can simply rename the directory according to the 
  275.       new ordering (or, if you've decided to take our advice, 
  276.       according to the topic).  While DOS does not allow you to 
  277.       rename directories, there are many utilities available that do 
  278.       provide this capability.  One that I've used for quite some 
  279.       time is Directory Freedom.  Look for DFxxx.ZIP if you want to 
  280.       give it a try.
  281.       
  282.       The unregistered demo version of GAP_Merge will merge only the 
  283.       first Area/Subject from the source filebase.  There is no way 
  284.       to do a complete merge with the demo unless the source 
  285.       filebase has only one Area/Subject.
  286.       
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.                                       -5-                                 
  329.  
  330.  
  331.